Reembolsando um Pix Recebido

Após a criação de uma cobrança Pix, e efetivado o recebimento de um valor (cash-in), o recebedor pode realizar a devolução de uma quantia, sendo total ou parcial para o pagador.

atenção

📘 O processo de devolução somente poderá ser realizado até 90 dias após a data do recebimento.

🚧 Cada reembolso parcial só pode ser feito com uma diferença de 2 minutos de cada solicitação para evitar problemas. Qualquer solicitação feita com uma diferença abaixo de 2 minutos NÃO será processada.

PUT 'https://apisandbox.delbank.com.br/baas/api/v1/pix/:endToEndIdOriginal/refund'

Headers

Nome	Descrição
x-delbank-api-key	Obrigatório. Chave de API
IdempotencyKey	Obrigatório. Necessário para garantir a idempotência da operação, Obrigatório ser um "uuid v4"

Parâmetros Path

Nome	Tipo	Descrição
endToEndIdOriginal	string	Obrigatório. O end to end da transação original

Corpo da Requisição

Name	Type	Description
externalId	string	Não deve exceder 40 caracteres. Caso deseje passar um Id para conciliação.
amount	number	Obrigatório. Valor a ser reembolsado
description	string	descrição da transação

Exemplo

{
    "description": "Pix recebido de forma errada",
    "amount": 0.01
}

Resposta

O código de status 202 http indica uma transação bem-sucedida.

{
    "idempotencyKey": "421ece97-a8d2-4c45-afaf-3c8f81666fd2",
    "externalId": "158412e7-b97a-4ad5-ab70-f0d6aabee6e6",
    "endToEndId": "D38224857202502281706FA489GE2ZSN",
    "status": "PIX_PROCESSING",
    "createdAt": "2025-02-28T17:06:41.963Z"
}